home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 4.iso / dist / fw_xmove.idb / usr / freeware / catman / u_man / cat1 / xmovectrl.Z / xmovectrl
Text File  |  1999-04-16  |  11KB  |  199 lines
  1.  
  2.  
  3.  
  4.      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((33330000 NNNNoooovvvveeeemmmmbbbbeeeerrrr    1111999999994444))))      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       xmovectrl - xmove control program
  10.  
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       xxxxmmmmoooovvvveeeeccccttttrrrrllll [ _x_m_o_v_e__D_I_S_P_L_A_Y ] _c_o_m_m_a_n_d [    _a_r_g_s ] ...
  14.  
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       xxxxmmmmoooovvvveeeeccccttttrrrrllll is a command program which sends commands to an
  18.       xxxxmmmmoooovvvveeee    pseudoserver. The commands allow you to    obtain a list
  19.       of clients under control of the xxxxmmmmoooovvvveeee,,,, to move some or all
  20.       clients to a new server, or to tell xmove to exit.
  21.  
  22.       The environment variable DDDDIIIISSSSPPPPLLLLAAAAYYYY is used to determine    the
  23.       xxxxmmmmoooovvvveeee    to access, since access    to xxxxmmmmoooovvvveeee is through a standard
  24.       X connection.     This default can be overridden    by specifying
  25.       the display connection for the xxxxmmmmoooovvvveeee pseudoserver as
  26.       _x_m_o_v_e__D_I_S_P_L_A_Y    on the command line.
  27.  
  28.       Because xxxxmmmmoooovvvveeee    supports host-level and    MMMMIIIITTTT----MMMMAAAAGGGGIIIICCCC----CCCCOOOOOOOOKKKKIIIIEEEE----1111
  29.       security, any    connection from    an xxxxmmmmoooovvvveeeeccccttttrrrrllll will be rejected
  30.       unless the user is permitted access to _x_m_o_v_e'_s default
  31.       display. See xxxxmmmmoooovvvveeee((((1111))))    for details about security and
  32.       authorization.
  33.  
  34.  
  35.  
  36.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  37.       The command options determine    the action taken by the
  38.       accessed xxxxmmmmoooovvvveeee pseudoserver:
  39.  
  40.       ----lllliiiisssstttt
  41.            This command takes no arguments.    In response to this
  42.            command,    xxxxmmmmoooovvvveeeeccccttttrrrrllll prints a list    of all clients that
  43.            are currently under control of the xxxxmmmmoooovvvveeee    pseudoserver.
  44.            These include both clients started directly under
  45.            control of the pseudoserver and clients which were
  46.            moved from other    machines. For example:
  47.  
  48.            vvvvaaaaggggaaaabbbboooonnnndddd%%%% xxxxmmmmoooovvvveeeeccccttttrrrrllll ----lllliiiisssstttt
  49.            1111     ggggnnnnuuuueeeemmmmaaaaccccssss:::: EEEEmmmmaaaaccccssss @@@@ ssssaaaa llllooooccccaaaallll
  50.            2222     xxxxtttteeeerrrrmmmm          llllooooccccaaaallll
  51.            4444     xxxxvvvv    iiiinnnnffffoooo          ppppeeeeaaaabbbbooooddddyyyy::::0000
  52.            5555     FFFFMMMM:::: WWWWaaaasssstttteeee::::VVVV3333....3333 AAAAllllpppphhhhaaaa ssssuuuussssppppeeeennnnddddeeeedddd
  53.  
  54.            Each line contains information on a single client. The
  55.            first column contains a number identifying the
  56.            particular client. When you wish    to move    a client, use
  57.            this number to specify it.  If more than    one line has
  58.            the same    client identification number, xxxxmmmmoooovvvveeee believes
  59.            the two clients both belong to the same application,
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 2/3/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((33330000 NNNNoooovvvveeeemmmmbbbbeeeerrrr    1111999999994444))))      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))
  71.  
  72.  
  73.  
  74.            and attempting to move one will cause the other to move
  75.            also.  The second column    contains a textual
  76.            identification of the client.  xxxxmmmmoooovvvveeee obtains this
  77.            information as the title    string from the    first window
  78.            created by the client, but that may not always be the
  79.            main application    window.     In the    example, client    number
  80.            5's identification should be "File Manager", but    the
  81.            File Manager application    creates    two windows, the first
  82.            of which    is for a wastecan.  The    third column specifies
  83.            the server on which the client is currently being
  84.            displayed. In this column the word 'local' means    that
  85.            the client is being displayed on    xxxxmmmmoooovvvveeee''''ssss    default
  86.            server, and the word 'suspended'    means that the client
  87.            is in suspended animation, ie. the client is not
  88.            currently being displayed on any    server.
  89.  
  90.       ----mmmmoooovvvveeeeaaaallllllll _t_o__m_a_c_h_i_n_e__n_a_m_e
  91.            This command takes as its only argument the name    of a
  92.            host machine to which all the clients at    this xxxxmmmmoooovvvveeee are
  93.            moved.  In general it should only be necessary to
  94.            specify a machine name as the location, since xxxxmmmmoooovvvveeee
  95.            will try    to find    another    xxxxmmmmoooovvvveeee at _t_o__m_a_c_h_i_n_e__n_a_m_e::::1111,,,,
  96.            and if it does not find one it will connect directly to
  97.            the server at _t_o__m_a_c_h_i_n_e__n_a_m_e::::0000....     If you    wish to
  98.            override    these defaults you can specify a full display
  99.            name instead of just a machine name.
  100.  
  101.            If the machine to which you are moving is multiheaded,
  102.            you can use the ''''----ssssccccrrrreeeeeeeennnn    nnnn'''' option, where _n is the
  103.            screen number, immediately after    the name of the    new
  104.            host, in    order to specify a particular screen.  For
  105.            example:
  106.  
  107.            vvvvaaaaggggaaaabbbboooonnnndddd%%%% xxxxmmmmoooovvvveeeeccccttttrrrrllll ----mmmmoooovvvveeeeaaaallllllll sssspppprrrruuuucccceeee ----ssssccccrrrreeeeeeeennnn 1111
  108.  
  109.            Will move all client to screen 1    on host    spruce.
  110.  
  111.            The time    required to move a client should be roughly
  112.            comparable to the time that the client takes to display
  113.            when first started. Clients will    be unresponsive    until
  114.            the last    one has    been moved. Then they will all begin
  115.            the process of refreshing their windows.
  116.  
  117.            New with    _x_m_o_v_e _1._2 is the ability to place a client in
  118.            suspended animation. This removes it from the display
  119.            without moving it onto another display. The server can
  120.            then go down without affecting the client. Later, the
  121.            client can be unsuspended by moving it to a new
  122.            display.    To suspend a client, move the client and
  123.            specify '-_s_u_s_p_e_n_d' as the name of the display to    which
  124.            it should be moved.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 2/3/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((33330000 NNNNoooovvvveeeemmmmbbbbeeeerrrr    1111999999994444))))      xxxxmmmmoooovvvveeeeccccttttrrrrllll((((1111))))
  137.  
  138.  
  139.  
  140.       ----mmmmoooovvvveeee    _t_o__m_a_c_h_i_n_e__n_a_m_e    _c_l_i_e_n_t__i_d__n_u_m_b_e_r__l_i_s_t
  141.            This command allows you to specify a list of client id
  142.            numbers for clients which should    be moved to the    new
  143.            display.    The client numbers should be separated by
  144.            spaces. For example:
  145.  
  146.            vvvvaaaaggggaaaabbbboooonnnndddd%%%% xxxxmmmmoooovvvveeeeccccttttrrrrllll ----mmmmoooovvvveeee ssssuuuunnnnttttaaaannnnaaaa 1111 7777 44442222
  147.  
  148.            Will move clients 1, 7 and 42 to    the machine named
  149.            suntana.
  150.  
  151.       ----sssseeeettttddddeeeeffffaaaauuuullllttttsssseeeerrrrvvvveeeerrrr _d_i_s_p_l_a_y__n_a_m_e
  152.            Changes xxxxmmmmoooovvvveeee''''ssss default server to display_name. The
  153.            default server is the display to    which xxxxmmmmoooovvvveeee sends
  154.            newly arriving applications. It should be set to    a full
  155.            display name, eg. spruce:0. If the specified display is
  156.            unusable    for any    reason the error will likely not be
  157.            detected    until the next time a new application or
  158.            xmovectrl is invoked.
  159.  
  160.       ----qqqquuuuiiiitttt
  161.            Causes the addressed xxxxmmmmoooovvvveeee and all applications under
  162.            it's control to exit.
  163.  
  164.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  165.       xxxxmmmmoooovvvveeee(1), xxxxhhhhoooosssstttt(1), xxxxaaaauuuutttthhhh(1),    XXXX11111111(7)
  166.  
  167.      NNNNOOOOTTTTEEEESSSS
  168.       xxxxmmmmoooovvvveeeeccccttttrrrrllll waits for the requested move to complete before
  169.       returning. Note that the move    cannot be cancelled by killing
  170.       xxxxmmmmoooovvvveeeeccccttttrrrrllll because the    move is    actually being done by the
  171.       xxxxmmmmoooovvvveeee    pseudoserver.
  172.  
  173.       Because xxxxmmmmoooovvvveeee    supports host-level and    xauth security,    any
  174.       connection from an xxxxmmmmoooovvvveeeeccccttttrrrrllll will be rejected    unless it is
  175.       run from a machine or    by a user who is permitted access to
  176.       xxxxmmmmoooovvvveeee''''ssss default display.
  177.  
  178.  
  179.      AAAAUUUUTTTTHHHHOOOORRRR
  180.       Ethan    Solomita, Columbia University
  181.  
  182.       This work was    supported by Professor Dan Duchamp of Columbia
  183.       University and by Dick Sillman and Jim Kempf of Sun
  184.       Microsystems,    Inc.
  185.  
  186.       Bug reports and other    problems should    be sent    to
  187.       ethan@cs.columbia.edu. Please    give all details, including
  188.       hardware configuration, make of X server and window manager.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 2/3/99)
  196.  
  197.  
  198.  
  199.